home *** CD-ROM | disk | FTP | other *** search
/ PC World 2006 February / PCWorld_2006-02_cd.bin / software / vyzkuste / klientip2p / klientip2p.exe / edonkey.exe / Plugins / LMA readme.txt < prev    next >
Text File  |  2005-08-17  |  5KB  |  129 lines
  1. Launch My App 1.6
  2.  
  3. Welcome to LMA! This plugin is used to call other applications from eDonkey2000/overnet.
  4.  
  5. It has two main functions:
  6.  
  7. 1) Calling a program when a file completes
  8. 2) Calling a program when the user click on the LMA menu
  9.  
  10. When a download completes, LMA will go through its list of programs and extensions to see
  11. if there is an appropriate program to launch. If it finds one, it will call it with
  12. the flags you specify, and the file as a command line parameter.
  13.  
  14. When you right click on the transfers view and select Plugins | Launch My App, it will
  15. look up which program to launch depending on the extension, and will send the partial
  16. files to it (with a flag if specified) to the program.
  17.  
  18. This means, only programs that are smart enough to handle the part files will work with
  19. this plugin!
  20.  
  21.  
  22. ----Configuration----
  23.  
  24. To configure Launch My App, go to Options | Plugins. Click on Launch My App and click
  25. on the configure button. You will be presented with a dialog box. You can enter
  26. your list of applications here. 
  27.  
  28. To add a new program, click on Add.
  29.  
  30. To remove a program, select it and click Remove.
  31.  
  32. To change to order of the programs, select it and click move up or down (when an app
  33. is going to be launched, it will look down the list in order until it finds a match,
  34. so moving an app up will cause it to be launched if there are multiple apps that
  35. have the same extension in their lists)
  36.  
  37. Once you clicked Add you will see a "..." on the first column. Click on this to see a drop
  38. down box to choose the action you want to cause this application to be launched.
  39.  
  40. Then, click on the box next to it to launch the application chooser. Look for the program you
  41. want to launch when the action takes place.
  42.  
  43. Then click on the next box to enter any flags that the program needs to launch these files
  44. (some programs might need flags to accept command line parameters, or to know to do something
  45. special with part files)
  46.  
  47. Finally, enter the extensions the application will accept. It should be in a comma seperated format
  48. like this 
  49.  
  50. txt,nfo,doc,rtf
  51.  
  52. Options:
  53.  
  54. Run every matching app: This will run through all matching applications you have that have
  55. the extension in their list. If you have this unchecked, it will stop after it finds the 
  56. first one.
  57.  
  58. Echo actions in console: Will display text on the console when the plugin launches the
  59. apps.
  60.  
  61. -----Some examples-----
  62.  
  63. Lets say I want to have all my text files launch in notepad when they finish.
  64.  
  65. Launch On Complete | c:\windows\notepad.exe | | nfo,txt,rtf,doc
  66.  
  67. Or I could use a previewer to preview my partial files (if it supports this operation)
  68.  
  69. Launch On Click | c:\program files\SuperPreviewerProgram.exe | -partials | wav,mp3,avi,mpg
  70.  
  71. Or, I could write a program to play a wav file when a movie is completed
  72.  
  73. Launch On Complete | C:\program files\playMySound.exe | | avi,mov,mpg,div
  74.  
  75. where playMySound actually ingores the command line and just playes a sound. Or even
  76.  
  77. Launch On Complete | C:\program files\playMySound.exe | completedFile.wav | avi,mov,mpg,div
  78.  
  79. where playMySound only reads the first command line parameter and playes it (completedFile.wav) and
  80. ignores the rest (otherwise it would try and "play" the movie files, ruining your speakers ;) )
  81.  
  82. If you wanted the files to actually play when you're done downloading them, you could do
  83.  
  84. Launch On Complete | C:\program files\Winamp\winamp.exe | | wav,mp3,ogg
  85.  
  86. Or, you could virus scan your executables and naughty document files
  87.  
  88. Launch On Complete | c:\program files\virusscanner.exe | | exe,com,bat,doc,xls,mp3
  89.  
  90. ------------------------
  91.  
  92. There are lots of possiblities, but it relies on the abilities of the programs you call, not
  93. so much so with "Launch on complete", since it will usually do the right thing if it can handle
  94. command line parameters, but "Launch on click" will only work if they understand how to decode
  95. the part files! I'm sure someone will write a previewer that will work with this plugin (hint hint
  96. programmers!)
  97.  
  98. anyway, hope it works for you.
  99.  
  100. If there are bugs, email them to me at
  101.  
  102. (c n o j i m a (at) o v e r n e t . c o m)
  103.  
  104. thanks
  105.  
  106.  
  107. ---- change log ------
  108.  
  109. 1.6
  110. Added support for new eDonkey2000/overnet temp filesystem (0.49)
  111. Added option that makes blank extensions mean "every file"
  112.  
  113. 1.5
  114. Plugin would crash if you tried to configure when it wasn't really loaded.
  115.  
  116. 1.4
  117. First field would get cut off in config dlg
  118.  
  119. 1.3
  120. First public release
  121. Versioning
  122. Echo, running matching apps options
  123. Bitfield stuff
  124.  
  125. 1.1 - 1.2 
  126. Beta releases
  127.  
  128. 1.0
  129. Alpha release